-
Notifications
You must be signed in to change notification settings - Fork 498
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
How Clerk Works #1735
How Clerk Works #1735
Conversation
Hey, here’s your docs preview: https://clerk.com/docs/pr/1735 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is legit awesome. Left a couple of random comments that popped up as I read it.
6b6d213
to
56cb4c7
Compare
56cb4c7
to
c4f3c47
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ok sorry this took so long to take a pass on, here's a first round. I have a couple more minor edits I'm pushing in a commit direct. I think there's a few more adjustments needed here, but it's close. Let's ship this week!
Co-authored-by: Jeff Escalante <[email protected]>
Co-authored-by: Jeff Escalante <[email protected]>
Co-authored-by: Jeff Escalante <[email protected]>
Co-authored-by: Jeff Escalante <[email protected]>
docs/how-clerk-works/overview.mdx
Outdated
Clerk implements a hybrid authentication model that combines the benefits of both stateful and stateless approaches while mitigating their respective drawbacks, at the cost of adding a substantial amount of complexity to the implementation on Clerk's side. For a developer implementing Clerk, like you, this is all upside since the complexity is handled internally by Clerk. The hybrid model incorporates the same flow when signing in as the stateless flow, but with a few key innovations: | ||
|
||
- A short-lived **session token** (60 seconds) combined with a background token refresh mechanism. | ||
- A **client token** to verify the user's authentication state, in conjunction with the session token. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
let's pair and drive it home more!
Co-authored-by: Alexis Aguilar <[email protected]>
Co-authored-by: Alexis Aguilar <[email protected]>
Co-authored-by: Mike Wickett <[email protected]> Co-authored-by: Alexis Aguilar <[email protected]>
Important
🔎 Previews:
It's been a long time coming, but finally it's here - how Clerk actually works, in the docs 🙌
Checklist